NAVAL POSTGRADUATE SCHOOL 

Monterey, California 






THE DESIGN AMD I MPLEP-'ENTAT | DM 
DF AN INEXPENSIVE 
MICROPROCESSOR DEVELOPMENT SYSTEM 
FOR THE Z-80 M I CPOPPOCESSOP 

bv 

Douglas Floyd Corteville 
June 1979 



Thesis Advisor: R. Panholzer 



Approved for public release; distribution unlimited. 



T189168 




t 






I 




I 






security classification of this page (Whmn Dmtm Entmrmd ) 



REPORT DOCUMENTATION PAGE 


READ INSTRUCTIONS 
BEFORE COMPLETrNG FORM 


1. REPORT NUMBER 


2. GOVT ACCESSION NO. 


3. RECIPIENT’S CATALOG NUMBER 


4. TITLE fand 

The Design and Implementation of an 
Inexpensive Mi croprocessor Development 
System for the Z-80 M i c roprocessor 


5. TYPE OF REPORT 4 PERIOD COVERED 

Master's Thesis; June i 


6. performing ORG. REPORT number 


7. AUTHORI".; 

Douglas Floyd Corteville 


8. contract or grant NUM8ERr«J 


9. PERFORMING ORGANIZATION NAME ANO AOORESS 

Naval Postgraduate School 
Monterey, California 93P40 


10. program element, project, task 

AREA 4 WORK UNIT NUMBERS 


II. CONTROLLING OFFICE NAME AND ADDRESS 

Naval Postgraduate School 
'•''onterey, California 93940 


12. REPORT DATE 

June 107°. 


13. number of pages 
101 


14. MONITORING AGENCY NAME 4 AOOR ESSf// d///»r*nf from ControtUnA OtUcm) 

Naval Postgraduate School 
Monterey, California 93940 


IS. SECURITY CLASS, (at Ihia r»>orf; 

Unclassified 


Mm. declassification/ DOWNGRADING 
SCHEDULE 



16. distribution statement (ot thim Rmport) 



Approved for public release; distribution unlimited. 



17. DISTRIBUTION STATEMENT (of thm obrntemct ontmrod In Block 70, it dlUtront from Rmport) 



18. SUPPLEMENT ARY NOTES 



9. KEY WORDS fContinu* on rmvmrmm midm U nmcommoty mnd Idmntify try block numbmr) 

Z-80, mi c rop rocesso r development system. 



>. ABSTRACT (Contlmtm on rmvmrmm aidm H nmcmmmmry mnd Idmntity by block numtomr) 



The Radio Shack home computer system, TPS-80, configured 
with Level II Basic R0M^*'s, 16K of PAM, its expansion interface, 
a single disk drive, and a line printer interface to the 
TELETYPE model 40 line printer is being used as a mi croprocessor 
evelopment aid for the Z-80 mi croprocessor . Basic language 
programs are resident on the mini-disk and are used to load. 



DO 1 473 COITION OF I NOV 68 IS OBSOLETE 

(Page 1) S/N 0 102-014- 6601 I 2 



security CLASSIFICATION OF THIS PAGE (Whmn Dmtm tntmr 



^t^C UPlTY classification Of THIS f> ^GEC^^n Df>t< Enfr^d - ._ 

to store, to dump, and to execute assembled assembly language 
programs . 



DD Form 1473 
, 1 Jan 73 

S/N 0102-014-G601 



2 SeCU«tTY CLASSIF-IC ATION Of ^HlS PAGEp»7>#n Dmtm Enfrma) 




i''" ■ 






I 





m 



Approved for public release; distribution unlimited 



THE DESIGN AND IMPLEMENTATION OF AN INEXPENSIVE 
Ml CROPPOCESSOR DEVELOPMENT SYSTEM FO® THE Z-80 

Ml CROPROCESSOP 



by 



Douglas Floyd porteville 
Lieutenant, United States Navy 
B.S., Michigan State University, June 1972 



Submitted in partial fulfillment of the 
requirements for the degree of 



MASTER OF SCIENCE IN ELECTRICAL ENGINEERING 



from the 

NAVAL POSTGRADUATE SCHOOL 



June 1979 



ABSTRACT 



r, L 



The Radio Shack home computer system, TRS-80, 
configured with Level II Basic ROM's, 16K of SAM, its 
expansion interface, a single disk drive, and a line 
printer interface to the Teletype model '40 line 
printer is being used as a microprocessor development 
aid for the Z-90 microprocessor. Basic language 
programs are resident on the mini-disk and are used to 
load, to store, to dump, and to execute assembled 
assembly language programs. 
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I. INriODUCTION 



The initai condition of the Naval Posrgraduate School's 
Radio Shade home computer was a Level I basic system with 
16K of RAM. This beginning system was added to and modified 
to form a microprocessor development aid for the Z-30 
microprocessor. 

Chapter II will discuss the conversion of the Level I 
basic to Level II basic. This being complicated by Radio 
Shack's lack of documentation and instructions was 
accomplished within one afternoon. With instructions it 
would take about fifteen minutes 



Chapter III will discuss the operation and construction 
of the line printer interface. This interface is controlled 
oy an INTEL 3743 microprocessor and is set to operate at 
2400 baud. A significant amount of time was spent on this 
due to a standard line feed character not being generated by 
the TRS-80. 



In chapter IV the microprocessor development aid is 
discussed with application to sample proolems. The use of a 
system of basic language programs resident on the mini-disK 
allows the operator to load, to dump, to store, and to 
execute assembled assembly language programs. The outputs 
of these operations are either directed to the video display 
or the line printer. Jse of the system's single step 
execution program allows the operator to trace the 
operations on each register as the operations are 
accomplished . 
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The conclusioQS aad ceco mmendatioas of chapter 7 include 
ideas for furthering the usefulness of the TRS-80 as a 
development tool. The prospects of increasing the variety 
of microprocessors serviced by this inexpensive system is 
very exciting. 



II. 



CONVERSION TO LEVEL II BASIC 



The conversion to Laval II basic from Level I basic was 
the first hardwara change made to tte Naval Postgraduate 
School's TRS-80. This changes the of ROM usad for Level 
I oasic to 12K of ROM used for Level II basic. An increased 
instruction set and the software to support a line printer 
are the motivating factors for this alteration. Normally a 
Radio Shack service center would install and test the 
conversion kit. Since this is an electrical engineering 
thesis, it was decided that I would do the conversion and 
thus have an opportunity to study the CPrj board. 

The use of Ref. 1 during the Level II basic conversion 
is useful and the only available reference. All of the "S " 
numbers are on the CPU ooard and therefore their locations 
are relatively easy to find. A new I3 is provided with tae 
conversion kit and is used as is (DO NOT break any of the 13 
connectors). The tit also has a 100 ohm 1/4 watt resistor. 
This resistor is used to load the recorder input but is not 
necessary; therefore, it is not used 

The Level II basic ROM's are on a small 4-chip ROM 
board. This ROM board is attached with double-sided tape to 
the etched side of the CPU board. The ROM board has a flat 
ribbon cable used to connect it to the CPU board at Z33 or 
Z3 4 



There are four lose wires coming from the ROM board 
which must be connected to the CPU board: A yellow wire to 
De connected to address line 11 (All) ; A red wire to be 
connected to address line 12 (A12) ; An orange wire to be 
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to 



ba 

for 



connected 
connected 
the color 



to adirass linj 13 (S.13); A green wire 

to something cilled ROM*. One mast be careful 
coding may change with diffarant ROM boards. 



ROM* is not defined in Ref. 1. ROM* must oa high when 
A14 or A15 is high and is low otherwise, in order to support 
the memory map. Knowing what maxes up ROM* leads to where 
it connects on tha CPU board. On IRS-80 schematic (sheet 1) 
of reference 1, there is the DIP shunt 13. This DIP shunt is 
a shorting bar array. By breaking some bars and leaving 
others intact, the address decoder is programmed to reflect 
the amount of ROM and RA.1 on the CPU board. For a Level II 
basic ROM and 16K of RAM none of the bars of X3 are broken. 
ROM* is now found on pin 7 or 8 of 13 with an unbroken DIP 
is installed 



con 
iso 
Z37 
(A1 
13 . 



The wires conn 


ecting to All, 


k^ 2, 


A13 


must all 


be 


nected to tha 


output of the 


tri- 


state 


buffers which 


late the CPU. C 


onnect the yellow 


wire 


(A1 1) 


to pin 5 


of 



, the red 


w ire 


(A12) 


to pin 13 


of Z21, the orang 


3) to pin 3 


of Z21 


, and 


the green 


wire (ROM*) to pi 



Appendix A contains a 
above conversion. 



step-by-step procedure for the 
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Given the need for hard copy output and the ex 
a line printer which receives RS-232 signals, an 
was constructed to convert the TRS-30's expansion 
and the Teletype aodel hO line printer. 



stence of 
interface 
int erface 



A. 



OPERATION OF THE 



LINE 



PRINTER INTERFACE 



The line printer interface must interface between the 
TTL parallel output and handshaking signals of the expansion 
interface and the RS-232, at 2400 baud, signals of the 
Teletype model 40 line printer. A universal asynchronous 
receiver/transmiter (OAR/T) the AY-5-1013 is used with a 
quad HDTL line driver the MC1438 to convert the parallel 
output of the expansion interface to 2400 oaud RS-232 
signals. A handshaking signal from the line printer is 
converted to TTL logic in a quad NDTL line receiver the 



MC1489. 
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The TRS-30 software does not generate an ASCII Line feed 
character at the end of a line. This requires a smart line 
printer interface. An ISTEL 87i8 is used to control the 
handshaking signals, aoiitor the parallel output from the 
TRS-80, and when required take control of the printer to 
generate a line feed character. A line feed is generated 
after the TRS-80 transmits a carriage return. 

Whenever the line printer interface and the disk drive 
are connected to the expansion interface, the line printer 
interface must be turned on. Tne lack of the proper 
handshaking signals, when the line printer interface is off, 
will prevent disk operation on start up and lock up tne 
system during operation. Before tne first use of the line 
printer interface after a shut down tie RESET button must be 
pressed on the line printer interface to insure proper 
restart of the 8748. 



3. INSIDE THE LINE PRINCSR INTERFACE 



Inside the line printer interface is divided into four 
parts. The transmit data path is discussed first. This is 
the pata from the TRS-80 through the line printer interface 
to the line printer. The second part is the received data 
path which is the handshaxe signal from the line printer to 
the TRS-80. The control signals are generated next and pull 
together both transmit and receive signals along with the 
necessary clock pulses. The power supply of the line 
printer interface is examined for possible trouble shooting 
at a later date. 



The line printer interface is made from three LSI and 
five SSI building blocks. One 3748 microprocessor, one 
Ay-5-1013 UAR/T, one 3212 eight-bit iaput/oucput port., one 
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74126 tri-state quad jaffer, ona dC1488 quad MDTL Lins 
driver, one MC1489 quad UDIL line caoeiver, and two 7492 
divide-by-12 countars are the integrated circuit components 
of the Line printer interface. Thara are an addicional six 
SSI building blocks on tna expansion interface which support 
the line printer. These circuits decode the Line printar 
driver address, store the output data cnaracter, receive the 
handshaking signals, and produce a 1/2 microsecond negative 
going data strobe to signal when data is present. Detailed 
data on the operation of ail the components of the line 
printer interface appear in Refs. 2, 3 and 4. 

1. Transmit 



The transmit data path through the line printer 
interface is shown in figure 1. Parallel data is latched on 
the expansion interface. This data is passed through the 
8212 configured as an output port to the UAH/T. The 8748 
can read the data which is passed to the UAR/T or, as will be 
seen during the control iiscussion, the 3748 can write data 
to the UAR/T. The UAH/T changes the data from parallel to 
serial at the baud rate maintained oy tna control signals. 
The TTL serial output of the iJA3/T is changed to RS-232 
logic in the HC1488 and sent to the line printer through pin 
3 of an RS-232 connector. 



2 . Rec eive 



The receive data path from the line printer to the 
expansion interface is shown in figure 2. Pin 14 of the 
RS-232 connector is the receive next cnaracter (RfIC) signal 
of the line printer. When this signal is low, the line 
printer is not ready to receive the next cnaracter. Likewise 
when this signal is high, the printar is ready to receive a 
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Figica 1 - TBANSail 
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To pin o: 
RS-232 connector 



Figacs 2 - 3EC2IVF 
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hanged to 



character. The RS-232 Logic of the printer is c 
TTL logic by the dC1489. ^ low on LP-23 of the expansion 
interface causes the rR3-80 to halt until LP-23 goes hign. 
This is also connected to T1 of the 3743 for use in the 
control sequence. The timing is such that this signal will 
not slow down the process unless a line feed or a form feed 
is being executed. 

3 . Contro l 
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imes the iesired baud 



The control of the line feed character generation 



works as 


follows. Three 


of 


the data lines of port ? 


1 


and 


one of 


the data lines 


of 


port P2 of the 3748 are us 


ed 


for 


control. 


Initially, the 


385 


port, which is monitorin 


g 


the 


transmit 


ted character, is 


in 


a high impedance state. 


pi 


2 as 



high, enabling the 3212 through one of the 74126’ s buffers 
used as a driver. P11 is low, enaoling the IR5-93 througn 
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buffer 


on 


the 
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on 
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face 
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leads to 
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die 
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buff 


er 


w hich 
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P20. P23 


is 


high. 


but 



disconnected from the data strobe of the U&R/T (DS (not) ) . 



LP-26 
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clear line 


for 


the D flip-flops 


on the expansion 


inter 


face 


which stor 


es 


the transmitted 


character; it is 


wired 


high 


to disable 


the 


clear. The inte 


rrupt is enabled. 



The 


transmit sequence 


folio ws . 


A character is 


latched to t 


h e 


D flip-flops 


on 


the exp 


ansion interface. 


This char act 


er 


passes through 


the 


8212 and 


appears on the 
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Fijace 3 - COMTROL 
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data lines of the UAH/T aad the BDS of the 8748. A negative 
going pulse of about 1/2 nicrosecond is generated on the 
expansion interface and is passed from L?-1 through the 8212 
to DS (not) of the UAR/T. The end of character line (EOC) of 
the UAR/T goes low, interrupting the 3748, and the character 
is transmited by the UAR/I. The interrupted 8743 stops the 
TRS-80 by sending P11 high. It then inputs on the BOS the 
character and checks it to see if it is a carriage return 
(ODH) . If a carriage return character is not being 
transmitted, than the 8748 starts its end of interrupt 
sequence (to be described later) , If a carriage return is 
being transmitted, then the 8743 waits for the SOS to go 
high. At that time, P12 goes low to disable the 8212 
(places it in a high impedance state) and P10 goes high 
enabling the 74126's buffer to connect P20 to D3 (not) of the 
□AR/T. A line feed character (OAH) is places on the 8748*s 
BUS. P20 goes low, then high, thus generating a data strobe 
for the UAH/T. A line feed character is now being 
transmitted. The 3748 starts its end of interrupt sequence. 

During the end or interrupt sequence, the 3748 waits 
for the EOC to go high, then it. waits for T1 to go high. 
This means the 8743 waits for the UAR/T to finish 
transmitting, then it waits for the printer to say it is 
ready. When these things are true, a return from interrupt 
is executed. After the interrupt is reenabled, the initial 
conditions are reestanlished and the transmission of the 
next character is started. 

Appendix 3 is a complete listing of the program 
resident on the 3748. Along with supporting the above, the 
8748 also generates the clock for the UAR/T. The clock is 
generated by the 8748* s instruction ENTO CLK which places 
1/3 the 8748 's clock on the test line TO. This clock is 
divided by twelve and two by 7492 div ide-by-twel ve counters 
before the clock goes to the UAR/T at sixteen times the baud 
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rate. The variable inductor is used co fine tune the 87U8's 
clock, thus fine tuning the 2400 baud of the JAR/T. lo 
change to 4800 baud, disconnect the divide-by-two counter. 
Similarly to change to 9600 baud, disconnect the 
divide-by-two counter and rewire the divide- by-twelve 
counter to make a di vi de- by-six counter. 

The reset button wiring is shown as part of control, 
figure 3. Before one tries to disassemble the liie printer 
interface case, the reset button must be disconneoted first. 

4 . Powe r 



The power supply for the line printer interface is 
provided by a surplus radio telegraph power supply. It is 
rated at .5 amp at 5 volts, 125 ma at +12 voles, and 125 ma 
at -12 volts. Figure 4 shows the power supplies needed foe 
the line printer interface. Pins 34-39 of the QAR/T set up 
the OAH/T for one stop bit, seven bits per character, and 
even parity. Pins 13 and '4 are high on the 74126 co 
permanently enable two of the 74126' s tri-state buffers as 
drivers . 



C, CONSTRUCTION OF TH2 LINE PRINTER INTERFACE 

The line printer interface is constructed on a 
six-by-four inch perforated board using wire wrap sockets. 
The use of the wire wrap technique is a very significant 
contribution to the success of the line printer interface. 
The author has used wire wrapping on two ocher projects and 
never experienced a short or an open. He strongly 
recommends this technique for any prototype project. 
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Figure 4 - POWER 
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IV 



MICROPROCESSOR DEVELOPMENT AID 
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The cost of the IRS-80, as presently ronfigurei, 
compares favorably with the prompt- 30/85 . The system of 
basic language programs which operates the IRS-80 as a 
microprocessor development aid performs all of the functions 
of the prompt-80/85 with the exception of the PROM 
operations. Consideration will be gi/en zo extending this 
Z-80 development aid to include PROM operations. In 
addition to the prompt-8D/85 functions, this system has a 
single step execution operation which allows either hardcopy 
or video display of the registers after each step. 



A- THE SYSTEM 



The entire basic program to support the miccoprocessor 
development aid takes less then IIS oc RAM. In a IRS-80 with 
16K of RAM rhat would leave about 5K of RAM for the machine 
language programs. To facilitate the use of rhe system and 
memory usage, the TRS-30 disk operating system (TRSDOS) is 
used. 
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The software to support the TRSD3S uses aoout 10K of 
RAM, leaving lass than 6S of RAM for the systen programs. 
The basic programs are segmented into functional groups 
using less than 2K of RAM each. Each of these small 
programs which are resident on the disk are called from the 
disk by the monitor program. Each of the program segments 
calls another segment is its last step, thus the systen of 
programs loop from one to another. 

Witn 10K of RAM used by TRSDOS and about 2X of RAM used 
by the basic programs, this leaves a little more than 3K of 
RAM for the assembled assembly language programs. Any time 
an assembly language program of greacer than 3K is being 
developed, the developer should think about a higher level 
language to produce his software. When the Naval 
Postgraduate School's TR5-80 RAM is expanded to tiSK, the 
same restriction should be followed. 

On system start up, the number of files question should 
be answered by pressing ENTER; this defaults with three 
files. Since each file requires about 235 bytes of RAM, any 
answer other than the default will rob the system of the RAM 
required for executing its program. The memory size 
question should be answered with 29630 ENTER. This protects 
3K of RAM for the user's assembly language programs. 

The use of this systen is very mach dependent upon a 
strong background in 3080 and Z-30 assembly language. 
References 7, 3, 9, and 10 are recommended for the beginner 
in that order. An understanding of the assembly language and 
how it operates within the microprocessor cannot be replaced 
by this system of basic Language programs. 

B. THE BASIC PROGRAMS 
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the 



The programs used to support 
development aid are written in TRS-30 Disk 
5 and 6 apply. Their aiceoution is slower 
similar operating systems which are assembly 
An asserted attempt has been made to have the 
outputs closely resemble their counterparts 
TEKTRONIX 8002 systems. The programs are 
nature and require a ieveloper*s response 
times during execution. 



Examples of the use of 
sample labs in Appendices X, 'I, 
will be discussed later in this 



microprocessor 
Basic, reference 
man that of 
language based, 
inputs and the 
in r-BUG and the 
interactive in 
at appropriate 

these programs are given as 
and Z. Use of these Ians 
chapter. 



All of the basic programs, but one, are protective files 
as defined in Ref. 6. They cannot be loaded, altered or 
executed without the use of their password. The password 
used by ail the programs is DFC, the initals of the author. 
The disk's master password is the same as given in Ref. 5. 
It is not necessary to use or even know either password when 
using this microprocessor development aid. 

The basic programs of Appendices C through N, and ? 
through S are identical in content to those resident on the 
disk. However, to save memory locations, unnecessary spaces 
have been deleted for the programs on rhe disk. Since this 
entire thesis is being generated oy the TPS program, on the 
IBM 360, the appendices have additional spaces generated by 
TPS to make them more pleasing to the eye. Additionally the 
subroutine calls, which appear in most of the programs, call 
line numbers not present in Appendices C through N, and P 
through S. These subroutines appear in Appendices I, U, and 
V, but are resident on the disk in the basic program when 
required . 



25 



1 . Moni tor Prog ra m 



The monitor program. Appendix C, funcrions as its 
name implies. It establishes a starting position for the 
microprocessor development aid and allows the operator to 
chose the type of operation which he /ants to accomplish. To 
start the monitor and, therefore, start the microprocessor 
development aid, type RUN"S'’ and than prass ENTER. This will 
load and run the monitor program. ’*S" is a program which is 
one line long; that line is RUN "MONIIOR/BAS. DEC: 0" which 
could be entered directly. What occurs on RUN "5" is that 
the monitor program is found on disk drive 0 and loaded inro 
the RAM and then executed. 



The first requested input: from the monitor program 
is a request for one of two letters S or L, These stand for 
a short (very short) or long explanation of the commands 
which are recognized oy the monitor program. If the 
operator enters some character, group of characters, or the 
null character (by just pressing ENTER) , the program 
defaults by responding with the shorn explanation. 



After the operator responds to and receives his 
explanation, the program asks for a mode of operanion. The 
operator must then respond with one of a sen of characters 
used in the explanation. If the operator enrers a differenn 
snring of characters, then what appears in nhe explanation 
(spaces count) , the program defaults with the short 
explanation- It will continue giving the short explanation 
until a proper string of characters is entered. 



Upon receiving a 
monitor program directs 
of a new program. At the 



proper string of characters the 
the locating, loading and execution 
end of this, the monitor program is 
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no longer in the RAM. The monitor program is reloaded as a 
final step to eacd of rhe other modes of operation. Thus, 
the microprocessor development aid is self perpetuating. 

If, for any reason, the operator requires to get to 
the monitor program at some other time, press BREAK then 
type RUN "S" and press ENTER. 

2 . Dum £ Mod e 

To start the dump mode program, Appendii D, from the 
monitor program type DUMP, then press ENTER when the mode is 
requested. This program will provide, either in hard copy or 
on the video display, tae contents (in hexadecimal code) of 
any memory location or string of memory locations up to and 
including the entire 64K of RAM addressaole by the Z-30. 

The operator must provide, whan asked, a starting 
memory location in decimal, the number of memory locations 
in decimal and an indiration of video or line printer 
output. There is no default on the type of ourput, so if the 
operator enters something other than a single letter 7 for 
video or the two letter string LP for the line printer, 
there will be no output. The data is outputted in the 
following format per line: starting memory location of the 
line in decimal; starting memory location of tne line in 
hexadecimal; followed with sixteen bytes of data from the 
next sixteen memory locations. 

After the requested data is outputted, the program 
gives the operator an opportunity to start the dump program 
again. The program defaults on any character string other 
than lES to the monitor program. 
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The program outputs the hexadecimal memory 
and its current contents. When a question mark (? 
the operator can change tne memory location by ty? 
digit hexadecimal code and pressing ENTER. r 
defaults using only the first two characters 
multi-character string. If no characters are typed 
is pressed, the memory location is unchanged and t 
proceeds to the next memory location. The memor 
always increases and never decreases. 



To stop the loading process type ^OIT 
ENTER. This will start the monitor program. 
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The program traasfers control so that the machine language 
code is executed starting at that memory location. This 
execution is similar to the GO command of the prompt 80/85. 
The execution is stopped and control transferred oack to tae 
basic language program upon execution of a return wnich vas 
not proceeded by a call in the assembly language program. 
The OSHO instruction is used to transfer control. See Refs. 
5 and 6. 



When execution is complete, the operator is asked if 
further execution is required. If so, a YES is typed and 
ENTER pressed, then the basic language execution mode 
program is restarted asking for a starting memory location 
in decimal. The program defaults on any other character 
string than YES to the monitor program. 

The use of this mode should be limited to assembly 
language programs which have already been debugged. Since 
the execution is very rapid, at the Z-80 clock rate, any 
attempt to see single steps would be useless. Techniques 
for writing Z-80 assembly language programs for this system 
are discussed later. 



5- Sing le Stag Sxecution 



The single step execution mode is a system of eight 
basic language programs, Appendices G through N, and one 
machine language program. Appendix 3. The system of 
programs is started by typing S5 EXEC and pressing ENTER in 
response to the mode question of the monitor program. 
Single step execution will provide, either in hardcopy or on 
the video display, the program counter of the step being 
executed. The contents of each working register and the 
stack pointer, after the step is executed, is also 
outputted. The primary use of this sat of programs is as a 
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debugging aid. Foe loig machine Language pcDgcams the 
hardcopy output is essential, since the video display will 
contain no more than twelve lines of output. What follows is 
a functional explanation for each of the nine separate 
programs which make up the single step execution node. 

Single step execution program, Appendix 3, is the 
executive program of the single step execution node. It is 
run only once during the single step procedure, and this 
does the preliminary accounting procedures required for 
execution. It first loads the machine language program, 
appendix 0, into memory. The question of output is then 
addressed. The operator responds with a V or LP for either 
video or line printer output. The type of ourpur is stored 
in the least significant bit of memory location 73D0 Hex. 
There is no default for output; a zero in this location 
causes video output and a one causes line printer output. 
If some other string of characters is used to answer the 
output question, the contents of this bit remains unchanged 
and the output is either video or line prinrer. The last 
entry by the operator in this mode is a starting memory 
location in decimal. This location is now used by the system 
of programs as the program counter and is stored in memory 
location 73D2 and 73D3. Since the single step mode is using 
several programs, any information to be passed between the 
programs must be stored in the protected part of the 3Ad. 
Appendix W shows a memory map of tna protected portion of 
the RAM used by the single step execution mode. 

The Appendix G program, as a final step, loads and 
executes single step execution program 1, Appendix H. This, 
as well as the renaining single step execution programs, has 
no interactions with the operator. The program sets memory 
location 73D1 to zero. Hemory location 73D1 is called S 
throughout this set of programs. The output bit from memory 
location 73D0 is checked and a header is outputted as 
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The Appendix H program, as a final step, loads and 
executes single step execution program 2, Appendix I. This 
program performs a very fundamental function of a single 
step routine; it translates the hexadecimal code of the 
contents of the program counter's memory location into the 
length in bytes of the instruction to be executed. The 
variable N2 is used to store the number of bytes per current 
instruction, see Appendix W. Instead of using this variable 
in single step execution program 2, the program loads, then 
executes one of the four programs. Appendices J through d, 
depending on the number of bytes. 



If single step execution program 3 is executed next, 
then the instruction to be executed is one byte in length. 
There are four distinct classes of one byte instructions in 
the Z-00 language. There is a class which does not change 
the program counter except to move it. down to the next 
instruction. Niaty percent of the single byte instructions 
are like this. Another class is one that only changes the 
program counter. The only single byte instruction of this 
class is the JP(HL) instruction. The third class may change 
the program counter and the stack pointer. These are the 
return and conditional return instructions. The last class 
are the restart instructions. The single step execution 
program 3 separates these four classes of single byte 
instructions and set control codes to insure rneir proper 
execution within the single step framework. An Instruction 
which does not change the program counter will set d5 to 1 
and d6 to 3. An instruction to jump to HL will set d5 to 1, 
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M6 to 1, and places the new pcogram countec in memory 
locations 73E8 and 73E9. The returns checic to see if the 
return has had a corresponding call. The conditional 
returns are checked for the truth of the condition. If the 
return has a corresponding call, the returning program 
counter is placed in memory locations 73E8 and 73E9; the 
stack pointer is caused to increment twice; a5 is set to 1 
and 116 is set to 1 . If the return is a conditional return 
failing its condition, M5 is set to 1 and M6 is set to 2. 
If the return does not ha?e a corresponding call, then it is 
an end of program return; M5 is set to 2 and d6 is set zo 1. 
A restart instruction is not executed since its execution 
would transfer control to a Level II basic ROM memory 
location. A restart sets M5 to 1, M6 to 2, and prints a 
diagnostic on the video display. M5 and M5 are control 
variables which are stored in memory location 73D0, prior to 
the loading and execution of single step execution program 
7, Appendix N, as a last step of this program. 

Single step execution 4, Appendix K, is executed 
next, if tne instruction being executed is two bytes long. 
There are four classes of the two byte instructions. One 
type is executed directly and does not change the program 
counter. These instructions set d5 to 1 and M6 to 3. 
Another class are the jumps. The JP (IX) and J? (lY) 
instructions each set M5 to 1 and M6 to 1 , than place a new 
program counter in memory locations 73S8 and 73H9. The 
relative jump instruction decodes the new program ccuntec 
and then does the same as JP (IX) . The conditional relative 
jumps with a tcue condition act as a relative jump. If a 
false condition exists, than M5 is sat to 1 and M5 is set no 
2. If the special decrsmant relative jump (DJNZa) is being 
executed, then, in addition to the conditional relative jump 
procedure, the B register must be decremented. The third 
class is the return from interrupt and return from 

nonmaskable interrupt. This class sets M5 to 1 and M6 to 2, 
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and then outputs a diagnostic to the video display, 
instructions REII and REIN are emulated with no operations 
(NOP) . The last class of two bytes instructions are the 
iterative load, compare, input and output instructions 
(LDIH, LDDR, CPIR, CPDR, INIR, INDR, DTIR, and OIDR) . They 
set as to 1 and B6 to 3 which allows their execution to 
completion. A diagnosic is outputted to the video which 
explains that these instcuctions are executed dicectly with 
only one line of output. The control variables aS and a6 
are then stored in memory location 73D0; and the single step 
program 7, Appendix N, is loaded and executed. 

Single step execution program 5, Appendix L, is 

executed if the instruction being executed is three bytes in 
length. There are three classes of three byte instructions. 
The ones which do not change the program counter are 
executed directly. The control variables aS is set to 1 and 
a6 is set to 3. The second class is the jump and 

conditional jumps. The jump will set a5 to 1 and M6 to 1, 
and store the new prograa counter in memory locations 73E3 
and 73S9. A conditional jump is checlced for the truth of 
the condition. If the condition is true, then it is treated 
like a jump. If the condition is false, then a5 is set to 1 

and a6 is set to 2. The third class is the call and 

conditional calls. These act like jumps and conditional 
jumps with additional actions. The current program plus 
three must appear to be pushed on tne stack; the stack 
pointer decreased by two; and which is stored at 73D4 is 
decreased oy one. The control variables MS and M6 are stored 
at 73D0; then single step execution program 7, Appendix N, 
is loaded and executed. 

Single step execition program 5, Appendix a, is 
executed if the instruction being executed is four bytes 
long. The Z-80 language does not have any four byte 
instruction which changes the program counter. This program 
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sets the coatroi yariablas M5 to 1 and 116 to 3, and then 
stores them in memory location 73D0. The single step 
execution program 7, Appendix N, is then loaded and 
executed . 

Single step execution program 1 , Appendix If , is the 
ending executive program for each machine language program 
step. The program decodes K which is the number of lines 
that this program has printed since the last register header 
of single step execution program 2 was printed. L? is 
decoded. If LP is oae, then output goes to the line 

printer. If LP is zero, then output goes to the video 
display. U3 is decoded as the currant program counter. If a 
jump, call or return is to be executed, then N1 is decoded 
as the new program counter. M5 is decoded as 1 or 2. M6 is 
decoded as 1 , 2 or 3. N2 is decoded as the byte length of 
the machine language instruction being executed. If Jl6 is 
1, then the new program counter, HI, is stored in 73D2 and 
73D3 and the machine language program of appendix 0 is 
executed. If M6 is 2, then HI is set to H2 plus H3 (i.e., 
the new program counter is the old program counter plus the 
number of bytes of the executing instruction) ; and the steps 
done for il6 equal to 1 are carried oat. For botn !16 set to 
1 or 2, the contents of 73E3 to 73EB are either no 
operations (NOP) or previously set in single step execution 
programs 3, 4 or 5. If 36 is 3, than the instruction being 
executed is placed in 73E8 to 73EB (whith HOP'S in empty 
locations) ; and the steps used when 35 is 2 are carried out. 
Upon returning from the machine language program of appendix 
0, the program counter, registers and stack pointer are 
assembled and outputted as the variable LP dictates. If 35 
is 2, then the machine laaguage program is over (one more 
return than calls) . An and of execution message is printed 
on the video display and the monitor program is loaded and 
executed. If 35 is 1, then one is added to K. I f K is 
greater than 9 (i.e. ten lines of output has been 
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generated), then the program loops to single step execution 
program 1. If K is less than or equal to 9, then tns 
program loops to single step execution program 2. 



Figure 5 shows a flow chart of the single step 
execution programs. The nested operation of these programs 
takes twenty seconds of real time to execute one step. This 
gives the operator plenty of time to anticipate the changes 
which each step will make to the registers. For an 
experienced operator, it is far too long to wait for the 
next step. For that case using a hardcopy output is 

suggested. 



6. Disk St orage Mode 

To start the disk storage mode program, Appendix ?, 
from the monitor program type DSTORE, then press ENTER when 
the mode is requested. This program will store a machine 
language program on the disk. Even more generally, it will 
store any portion of memory on any disk, if more than one 
disk is connected to the system. 



The operator must provide a starting memory address 
in decimal, an ending memory address in decimal, and a 
filename. Reference 5 is the source for information on the 
optional parameters for filenames. The simplest filename is 
a name of no more than sight alpha-numeric chararters. The 
data is stored under the filename, tnerefore an easily 
remembered filename should be used. The program stores the 
data, reminds the operator of the filename in use, and then 
loads and executes the monitor program. 
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Figure 5 - SIN3LS STEP BX2CUTIDN FLOW ZBAST 
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7 . 



Dis k Recall Mode 

To start the disk recall mode ^prog raa, Appendix 2, 
from the monitor program type DRECALL, then press ENTER when 
the mode is requested. This program will load a machine 
language program into memory from a data file an the disk 
created by the DSTORE program. 

The operator must provide a starting memory address 
in decimal, an ending memory address in decimal, and the 
filename of the data file used during DSTORE to creare the 
file. After the machine language program is loaded, the 
operator is reminded which memory locations have been 
loaded. The monitor program is now loaded and executed. 

9 • Tape Storage Mode 

To start the tape storage mode program. Appendix 3, 
from the monitor program type TSTOHE, tnen press ENTER when 
the mode is requested. This program will store a machine 
language program on the tape recorder. 

The operator must provide a starting and ending 
memory address in decimal. The tape recorder must oe on and 
sat to record. There is no filename for the tape recorder 
storage in this applioation, so remember the starring and 
ending rape counter. The data is stored on the tape, 
sixteen bytes at a time. After the data is transfered to tne 
tape, the monitor program is loaded and executed. 

9 • T ape Recall Mo de 
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To start tha tapa recall mods program. Appendix S, 
from the monitor program type TRSCALL, then press ENTER whan 
the mode is requested. This program will load into the RA.1 
memory a machine language program which has been stored on 
the tape using TSTORE mode. 

The operator must provide a starting and ending 
memory address. The program expects the operator to place 
the tape recorder in play at about tne starting tipe counter 
used in the TSTORE mode. After the data is loaded in the 
RAM, the monitor program is loaded and executed. 

C. SPECIAL CONSIDERATIONS FOR MACHINE LANGUAGE PROGRAMMING 
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the supporting basic programs. The PEEK syntax ia the 
16K of SAa is PEEK (address) . The PEEK syntax for the R 
the expansion interface, at memory addresses abo'/e 327 
PEEK (- 1*addrass-32676) . To PEEK at address 40000 
instruction would be PEEK (- 1*7 233) . this limitation 
support software will not prevent the programmer from 
this additional memory as a stack or data storag 
machine language program. 
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The use of the keyboicd and other ROM subroutines will 
add a considerable dimension to machine language 
programming. At present. Ref. 9 is the sole source for ROM 
subroutine memory locations. In tae future, the Naval 



postgraduate School will have a complete listing 
subroutines for the programmer to utilize. 
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D. USING THE DEVELOPMENT SYSTEM 



The learning curve is a substantial barrier to the use 
of any new product or device. The same is true for any Z-80 
based system or project or the development system used to 
cceate the required software. To have a system of basic 
language programs which ace described as a microprocessor 
development aid for the Z-30 is not enough. A developer 
must have confidence in the system and must be helped to gat 
past the largest part of the learning curve- Appendices X, 
Y, and Z are designed as training sessions to help a new 
developer to learn the system, to develop confidence in the 
system’s ability to solve his problem, and to start with 
small successes on which larger projects can be built. 



1 . 1 . 

Appendix X, lab 1, first contains a very detailed 
power up procedure. The system has six power coeds, three 
edge connector cables, three connecting cables, and one 
RS-232 connecting cable- The sequence of powering up is 
important and should be followed each time by the operator. 
There are many other capabilities of the T3S-60 
microcomputer system. The operator should refer to Reis. 5 
and 6 when these other capabilities ace required. 
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The opecitor is then led through a sequence of 
operations which will retrieve a machine language program 
resident on the mini disk and places it in the protective 
portion of the RAd using the disk recall mode. The contents 
of the RAM is verified using the dump mode. This program is 
modified by the load mode and executed by the execute mode. 
The program uses the video RAM as an output and whitens the 
first 256 video RAM locations. 

The return at the end of the program which exists 
without a call is a signal to the TRS-30 to exit this 
machine language program and return to the basic language 
program. All programs written for this system must use an 
ending return. This return should be removed when tne 
program is used in a stand alone Z-80 system. 

At the end of lab 1, the operator is expected to 
understand the start up procedure, what is done by tne 
monitor program, and how some of the modes work. He should 
examine the machine language program at the end of this lab 
to gain an appreciation for what the program is 
accomplish! ng. 

2. Lab 2 

Lab 2, Appendix I, builds on the experience of lao 
1. A more complicated machine language program is used to 
demonstrate the use of the single step execution mode. 
There are four levels of calls during this program. The 
video memory location 3?F3 is used as an L3D and follows the 
line of registers, which produced it, up the video display 
as the video display scrolls. when the machine language 
program of lab 2 is single step executed using line printer 
output, t he video memory location is lit, but not 
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scrolled. 



The operator is to obtain an appreciation for the 
debugging potential of the single step execution mode of 
operation. He should also notice the absence of the prime 
registers from the single step execution printout. If the 
programmer requires the use of both sets of Z-33 registers, 
then he must change the program for it will not execute 
properly using the single step execution mode. 



3 . La^ 3 

Lab 3, Appendix Z, is a structured example of tne 
system’s use. The operator should begin this lab with a 
machine language program to debug. If the operator fails to 
write his own program, then a short program can be found at 
the end of the lab for this purpose. At the end of this Ian 
the operator will have operated all of the microprocessor 
development system. He has passed the largest portion of 
the system’s training curve and is ready to use the system 
for his own software development. 
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A. FUTURE SOFTWARE 



The software future of the TRS-30 microcomputer system 
is limited only by the ideas implemented with it. To 
support the Z-80 Radio Snack has distributed two software 
packages. T-303, Ref. 9, is a machine language program that 
will load, store on tape, dump, and execute wirh or without 
breakpoints. The TRS-30 Editor/Assemoier , Ref. 10, is a 
machine language program that will edit and assemble 

assembly language Z-80 programs. These machine language 
programs both take advantage of the basic ROM's subroutines. 
A major disadvantage of these programs is that they cannot, 
be used with the TRS-80 disk basic Language. To improve 
this Z-80 mice ocompiter development aid, a basic language 
program to relocate the I-BUG and Sdi tor/Assembler machine 
language programs to a portion of memory which is not used 
by disk basic is necessary to allow the use of these 



programs with dislc basic. 



A List of basic ROa subroutines which could be used as 
macro instructions in other machine language programs would 
add a new dimension to programming. To obtain these 
subroutines will require a disassembler program and a lot of 
bookkee ping. 

To expand the TEKTRONIX 8002 to include additional 
microprocessors will cost about two thousand dollars per 
additional microprocessor. The software required for che 
THS-80 X.0 supporr additional microprocessors will hav^e 
little direct cost. To expand the THS-80 to include 

development systems for microprocessors already supported oy 
the TEKTRONIX 8002 is not a time effective proposal. The 
software for the TRS-80 should be expanded no include 
INTEL'S 8748 microprocessor family. The 8748 microprocessor 
has the greatest potential for class project work. A 
development system for this family of microproce ssor s will 
go a long way to ease the burden of software development for 
rhe 8748. 



a. FUTURE HARDWARE 



There are several cost effective hardware additions to 
the TRS-80 microcomputer which will support a microprocessor 
development system. An Interface between the TRS-30 and the 
TEKTRONIX 3002 will provide an expanded disk capaoility, the 
sharing of an additional 54K of RAH, and the use of a PROH 
programmer. An interface between the TRS-30 and tne 
prompt-48 will provide additional hardware for a 3748 
microprocessor development system. The use or the 
prompt-48's PROM programmer and execution with or without 
br eakpo i nts will relieve some of the hardware requirements 
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the 



for such a system. kn iaterface betrfean the TRS-30 and 
IBM 360 will add mass storage capability ro any system. 



There are several 
which are not suppo 
microcomputer lab. T 
capability would be a 
support these PROMs, 
toward one PROM or a f 



new PROMs and at le 
rtad by the aguipme 
he TRS-80 with i 
logical choice of s 
A class project 
amlly of PROMs. 



ast one 
nt avail 
t s ba s i 
ystems t 
could b 



old 
able 
c la 
0 exp 
e di 



PROM 
in rha 
nguaga 
and to 
rected 
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APPENDIX A 



THE PROCEDURE FOR THE CONVERSION TO LEVEL II BASIC PROH 

LEVEL I BASIC 



1. Open CPU/lceyboacd cabinet, 

2. Remove Level I basic ROil's from sockets Z33 and/or 
Z34. 

3. Ping in the 24 pin header of the ROM board to Z33 or 
Z34 (Z33 is recommended) . 

4. Attach the ROM board to the etched side of the CPU 
board . 

5. Replace DIP shat X3 with the new DIP shut - 

6. Check the color code: yellow (All) , red (A12) , orange 
(A13) , green (ROM*) . 

a. Solder the yellow wire to pin 5 of Z37. 

b. Solder the rad wire to pin 13 of Z21. 

c. Solder the orange wire to pin 3 of Z21. 

d- Solder the green wire to pin 3 of X3 . 

7. Close CPU/keyboard cabinet. 
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000 

001 

002 

003 

004 

005 

006 

007 

008 

009 

OOA 

OOB 

OOC 

OOD 

OOE 

OOP 



APPENDIX 3 



THE 3748 PROGRAM TO GENERATE A LINE PEED 



HEX CODE 


MNEMONIC 


04 


JMP 


05 




00 


NOP 


04 


JMP 


28 




B8 


MOV R0,44 


44 




B9 


MOV R1 , 7F 


7F 




BA 


MOV R2,0D 


OD 




BB 


MOV R3,0A 


OA 




00 


NOP 


00 


NOP 


00 


NOP 



COMMENTS 

Powar Op Rasx.art 



Intarrupt Vector 
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MEa LOC 


HEX CODE 


MNEl ONIC 


COMMENTS 


010 


23 


MOV A, 01 




oil 


01 






012 


3k 


OUTL P2,A 


Hi-Z Dn DS (not) fcom 8748 


013 


00 


NOP 




014 


23 


MOV A,FF 




015 


FF 






016 


39 


OUTL PI ,A 


Enabias PI for OS's and 








AND's (not nacessacy in t 








Application) 


017 


00 


NOP 




018 


81 


MOVX A,R1 


Places BUS in Hi-Z State 


019 


00 


NOP 




OU 


75 


ENTO CLK 


Makas TO a clock at 1/3 








Tha 8748 Clock 


01B 


05 


EN I 


Enable Interrupt 


0 1C 


00 


NOP 




0 ID 


00 


NOP 




01 E 


00 


NOP 




OIF 


00 


NOP 




MEM LOC 


HEX CODS 


MNEMONIC 


COMMENTS 


020 


00 


NOP 




021 


F8 


MOV A,R0 





48 



022 


39 


OUTL PI, A 


Enaola 8212 and Eaable 








TRS-30 


023 


04 


JMP 


Loop to 020 Until 








Intent upted 


024 


20 






025 


00 


NOP 




026 


00 


NOP 




027 


00 


NOP 




028 


23 


MOV A, 6 6 


An lacercupt has Occurred 


029 


66 






02A 


39 


OUTL PI, A 


Stop TRS-80 


02B 


08 


INS A, BOS 


Input Last Character 


02C 


59 


ANL A, HI 


Insure Character is 7 Bits 


0 2D 


DA 


XRL A,R2 


Checic Last Character 








for Carriage Return 


02S 


00 


NOP 




02F 


00 


NOP 




MEM LOG 


HEX CODE 


MNEMONIC 


COMMENTS 


030 


96 


JNZ 


If No Carriage Return Starr 








End Interrupt Sequence 


031 


41 






032 


00 


NOP 




033 


86 


JNI 


Loop to 032 Until S0C=1 
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From OAST 



034 


32 






035 


00 


NOP 




036 


23 


MOV A, 33 




037 


33 






038 


39 


OOTL PI, A 


Disaola 8212 


039 


FB 


MOV A,R3 




03A 


02 


OUTL BUS, A 


Plara OA oq BUS for 








A Liaa Faad 


03B 


23 


MOV A, 00 




03C 


00 






03D 


3A 


OUTL P2,A 


P2 is Low to Start 








The Strobe to UARI 


032 


23 


MOV A , 1 1 




03F 


11 






aEM LOC 


HEX CODE 


MNEMONIC 


COMMENTS 


040 


3A 


OUTL P2,A 


End of Strobe to OART 


041 


81 


MOVX A, SI 


Placa BUS in Hi-Z State 


04 2 


00 


NOP 




043 


86 


JNI 


Loop ro 042 Until E0C=1 


044 


42 






045 


00 


NOP 




046 


46 


JT1 


Jump to 04A Whan Printer 



50 



Is Saady 



047 

048 



049 

04A 



4A 

04 JMP Loop to 045 Until Printer 

Is Ready 
45 

93 BETS Retarn from Interrupt 
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APPENDIX C 



aONITOR PROSRAa 



500 ' MONITOR: A Z-80 MICROPROCESSOR DEVELOPMENT AID FOR 

DISK BASIC ON THE TRS-30 3Z DF CORTEVILLE APR 79 

501 DEFSTR A-B 

502 PRINT "MONITOR PROGRAM" 

504 PRINT "A Z-80 MICROPROCESSOR DEVELOPMENT AID" 

506 INPUT "SHORT OR LONG EXPLANATION? INPUT S OR L";A 

508 IF A="S" PRINT " DUMP , LOAD , EXEC , 5 S EXEC , TSTO R E , TR ECAL L , 
DSTORE,DRECALL,END ,L" 



510 


IF A = " 


S" INPUT 


"MODE"; 


3 


512 


H 

II 


S" GOTO 
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514 


PRINT 


"INPUT: 


DUMP , 


TO 


EXAMINE MEMORY LOCATIONS" 


516 


PRINT 


"INPUT : 


LOAD, 


TO 


ENTER PROGRAM INTO MEMORY" 


513 


PRINT 


"INPUT: 


EXEC, 


TO 


RUN A PROGRAM" 


520 


PRINT 


"INPUT: 


SS EXE 


9 


TO SINGLE STEP THROUGH A PROGRAM" 


522 


PRINT 


"INPUT: 


DSTORE 


9 


TO STORE A PROGRAM ON THE DISK" 


524 


PRINT 


"INPUT: 


DRECALL, 


TO RETRIEVE A PROGRAM STORED ON 


THE 


DISK" 










526 


PRINT 


"INPUT: 


TSTORE 


9 


TO STORE A PROGRAM ON THE TAPS 


RECORDER" 










528 


PRINT 


"INPUT : 


TRECALL, 


TO RETRIEVE A PROGRAM STORED ON 



52 



THE 

530 

532 

534 

536 

538 

540 

542 

544 

546 

54 8 

550 

552 

554 



TAPE RECORDED" 



PRINT "INPUT; END, TO EXIT THIS DEVELOPMENT AID" 
INPUT B 

IF B="DUMP" RUN "DUMP/B AS. DFC: 0" 

IF B="LOAD" RUN "LO AD/B A S . D FC: 0 " 

IF B="EXEC" RUN " E XEC/B A S . D FC : 0 " 

IF B="SS EXEC" RUN "5 5 E XEC/B AS . DFC : 0 " 

IF B="DSTORE" RUN "DSTO R E/BA S . DFC : 0 " 

IF B = "DRECALL" RUN "DR EC ALL /BAS . DFC : 0 " 

IF B="TSTORE" RUN "TS T 0 RE/B AS . DFC : 0 " 

IF B="TRECALL" RUN "I REC ALL/BAS. DFC :0 " 

IF B="L" GOTO 514 
IF B="END" END 
A="S":GOTO 508 
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APPENDIX D 



DOMP PROGRAM 



5 'DUMP: A PART OF A Z-80 MICROPROCESSOR DEVELOPMENT AID FOR 

DISK BASIC OH THE TRS-80 81 DF CORTEVILLE APR 79 

10 CLEAR 300:DEFSTR A-B:DEFINT I-N 

15 PRINT "DUMP MOPE" 

20 INPUT "INPUT STARTING MEMORT LOCATION IN DECIMAL"; N1 
25 INPUT "INPUT NUMBER OF MEMORY LOCATION IN DECIMAL" ;N2 
30 PRINT "IS OUTPUT VIDEO OR FOR THE LINS PRINTER?" 

35 INPUT "INPUT V OR LP"; A 
40 N3=N1 

44 B1 = STR$(N1) 

45 N=N1 :0=4 ; GOSUB 100:31=81+" "+B 
50 FOR K=1 TO 16 

55 N=PEEK (N1) :0=2:G0SDB 100:B1 = B1 + " " + B:N1 = N1 + 1 
65 NEXT K 

70 IF A="V" PRINT B1 
75 IP A="LP" LPRINT B1 
30 IF NKN3+N2 GOTO 44 

35 INPUT"CONTINUE DUMPING (YES OR N0)";B 

90 IP B="YES" THEN 20 ELSE RUN "MONI TO R/B AS . DFC; 0 " 
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iPPENDIX E 



LOAD PROGRAM 



5 'LOAD: A PART OF A Z-80 MICROPROCESSOR DEVELOPMENT AID FOR 

DISK BASIC ON THE TRS-80 31 DF CORTEVILLE APR 79 

6 GOTO 300 

300 DEFINT I-0:DEFSTR A-B 
305 PRINT "LOAD flODE" 

310 INPUT "INPUT STARTING MEMORY LOCATION IN DECIMAL" ;N1 
315 PRINT "OUTPUT IS VIDEO - USE QUIT TO STOP LOADING" 

320 N=N1 :0=4:G0SU3 100:B1=B 

325 N=PEEK(N1) ;0=2 :GOSUB 100:B2=B 

330 B3=B1+" "+B2: PRINT B3; INPUT B 

335 IF B="QUIT" GOTO 350 

336 IF B="" GOTO 345 
340 GOSUB 200:POKE N1,N 
345 N1=N1+1;GOTO 320 

350 RUN "MONITOR/BAS. DFC; 0" 
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APPENDIX F 



EXECUTION PaOGSAfl 



6 GOTO 600 

600 'EXECUTION: A PART OF A Z-80 MICROPROCESSOR OEVELOPMENI 
AID FOR DISK BASIC ON THE IRS-80 BY DF CCRTEVILLE APR 79 

605 DEFSTR A-B:DEFINT I-O 

610 PRINT "EXECUTION MODE" 

615 INPUT "INPUT STARTING MEMORY LOCAIION IN DECIMAL"; N1 
620 N=N1 :0=4:G0SUB 100:PRINT "EXECUTION BEGINS AI ",3 
625 DEFUSR0=N1 

630 PRINT USR0(0)i " END EXECUTION" 

635 INPUT "CONTINUE EXECUTION MODE (YES OR NO) " ; B 
640 IF B="YES" THEN 61 0 
645 RUN "MONITOR/BAS. DFC: 0" 
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APPENDIX G 



SINGLE STEP EXECUIION PROGRAM 



1300 'SS EXEC: A PART OF A Z-80 MICROPROCESSOR DEVELOPMENT 
AID FOR DISK BASIC ON THE TRS-30 BY DF CORTEVILLE APR 79 

1305 DEFINT I-N:DIM I(19);DEFSTR A-B 

1310 I(0)= HED: I ( 1) = H73: I (2) = HCO : I (3) = H73 : I(4)= H3 1 : 

I(5)= HC2: I(6)= H73: I (7) = HCI : I{3)= HDI: I(9)= HE 1 ; 

I(10)= HF1: I(11)= HDD: I(12)= HE1 : I(13)= HFD; I(14)= HE1; 

I(15)= HED: I(16)= H7B: I(17)= HCE: I(18)= H73:N = 0 

1315 FOR N2=29653 TO 29671 

1320 POKE N2 ,I(N) : N=H+1 

1325 NEXT N2 

1330 I(2)= HCE: I (5) = HCE: I (7) = HFD: I (8) = HE5 : 1(9) = HDD; 

I(10)= HE5: I(11)= HF5; I(12)= HE5: I(13)= HD5: I(14)= HC5: 

I(17)= HCO: I(19)= HC9: N = 0 

1335 FOR N2=29676 TO 29695 

1340 POKE N2,I (N) ; N=N+1 

1345 NEXT N2 

1350 PRINT "IS ODIPUT FOR VIDEO OR LINE PRINTER" 

1355 INPUT "INPUT V OR LP";A 
1360 IF A="V" POKE 29648,0 
1365 IF A="LP" POKE 29648,1 
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1370 INPUT "STARTING NEMORI LOCATION IN 
1375 N1=N/256: N=N-N1*256 
1380 POKE 29650, N:POKE 2965 1 , N1 zPOKE 
1385 RUN "SSEXEC1/3AS. DEC: 0" 



DECIMAL"; N 



29652,127 
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APPENDIX H 



SINGLE STEP EXECOTION PROGRAM 1 



1 ' SSEXEC1/BAS. DFC;0 

1400 DEFSTR A-B:DBFINT 1-2 

1405 POKE 29649,0 

1410 K1=(PEEK( H73D0) AND HOI) 

1415 A="PC F A B 0 D E a L SP IX 

1420 IF K1=0 PRINT A 

1425 IF K1=1 LPRINT A 

1430 RON "SSEXEC2/BAS.DFT:0" 



II" 
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APPENDIX I 



SINGLE SCEP EXECUTION PROGRAM 2 



1 'SSEXEC2/BAS.DFC :0 

2 DEFSTS A-B:DEFINT I-Q 

6 FOR K1= 29672 TO 29675 

7 POKE K1,0 

8 NEXT K1 

9 N1=256*PEEK(29651) +PEEK(29650> :GOro 27 

27 M=PEEK (N1) : N=il/16 :GOSUB 10:31=B 

28 N=a-N*16: GOSOB 10:B2=B 

29 IF (B1="4" OR 31="5" OR B1="5" OR 31="7" OR B1="3” OR 
Bl = ''9" OS 31=*'A'' OR B1 = »B") GOTO 70 



30 


IF 


B2=»6" 


OR 32=*'E" goto 71 


31 


IF 


B2="1" 


AND B1=0" GOTO 72 


32 


IF 


B1="0" 


GOTO 70 


33 


IF 


B1="1" 


AND B2="0" goto 71 


34 


IF 


B1 ="1« 


AND B2='M'' GOTO 72 


35 


IF 


B1="1" 


AND B2 = ”8'‘ GOTO 71 


36 


IF 


B1="1" 


GOTO 70 


37 


IF 


B1="2" 


AND (B2 = " 1" OR B2 = ”2") 


38 


IF 


B2 = ''2» 


GOTO 72 
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39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 

62 

63 



IF 


B1="2" 


AND 


B2="8" 


GOTO 


71 


IF 


B2="A" 


GOTO 


72 






IF 


Bl="2" 


AND 


B2="0'' 


GOTO 


71 


IF 


B1 ='*2« 


GOTO 


70 






IF 


B1 ="3» 


AND 


B2="0" 


GOTO 


71 


IF 


B1=''3*' 


AND 


B2="1 " 


GOTO 


72 


IF 


B1=«3" 


AND 


B2="8» 


GOTO 


71 


IF 


B1 ="3" 


GOTO 


70 






IF 


B2 =''4” 


OR B2="C" 1 


GGTO 


72 


IF 


B1=''C' 


AND 


B2="3'* 


GOTO 


72 


IF 


B1=''C 


AND 


B2=''B» 


GOTO 


71 


IF 


B1 ="C« 


AND 


B2="D'* 


GOTO 


72 


IF 


B1=''D" 


AND 


B2="3» 


GOTO 


71 


IF 


31 = ''D« 


AND 


B2="B" 


GOTO 


71 


IF 


B2="D” 


THEN 


54 ELSE 70 





M=PEEK(N1+1) : N-M/16 :G03 0 3 10: B3=B 

N=M*16:G0S0B 10:34=3 

IF B1 = ''D" GOTO 59 

IF B1=«E" GOTO 66 

IF 31="F" THEN 59 ELSE STOP 

IF B3 = "C" or 34="A'* goto 73 

IF (B3="2" AND (B4 = "1" OR B4 = "2")) GOTO 73 

IF B3="3" and B4="6" GOTO 73 

IF B3 = "E’' OR B4 = "9" GOTO 71 
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64 IF B3 = '*2'' AND B4 = ”3" 3DT0 71 



65 IF B3 = '*2" AND B4 = "B" 30T0 72 

66 IF B3 = ''A» OR B3 = ''3« GOTO 71 

68 IP B4 = '»B» GOTO 73 

69 IF B4=»3" THEN 73 ELSE 71 

70 RUN ''SSEXEC3/BAS. DFC:0» 

71 RUN "SSEXSC4/BAS. DFC:D" 

72 RUN "SSEXEC5/BAS. DFC:D'» 

73 RUN "SSEXEC6/BAS. DFC;0" 



62 



APPENDIX J 



SINGLE STEP EXECDTION PROGfiAH 3 

1 ‘SSEXEC3/3AS.DFG:0 

2 DEFSTR A-B:DEFINT I-Q 

3 M4=PEEK (29652) :30SUB 3D:POKE 29652,^4 

4 N3=PEEK (29648) AND 1 

5 IF £15=2 N3=N3 OR 8 

6 IF M6=2 N3=N3 OS 16 

7 IF £16 = 3 N3=N3 OR 32 

8 POKE 29648, N3 

9 RUN "SSEXEC7/BAS .DEC :0" 

30 N1=256*PEEK (295 51) +PEEK (2 9650) : £1 = PEEK(N1): N = .1/15: GOSU3 
10: B1=B: N=fl-N=i‘16: GOSUB 10: 32=B: N= PEEK (2964 0) 

31 IF B1=“E" AND 32="9” SOTO 45 

32 IF B1="C« AND B2="9" GOTO 46 

33 IF B2<>"7" OR B10'‘F" GOTO 36 

34 IF B1=*'C" OR B1=«D" OR B1="S" OR 31="F" GOTO 49 

36 IF B1="C" AND B2=''0" GOTO 51 

37 IF 31="D» AND B2="0" GOTO 52 

38 IF B1=»E'' AND B2='*0” GOTO 53 

39 IF B1='*F»' AND B2 = "0" GOTO 54 
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40 IF B1="C" AND 32="8" 33TO 55 



41 IF B1="D" AND B2=''8" 33TO 56 

42 IF B1="E" AND 32="8" 3010 57 

43 IF B1="F” AND B2="8" 3010 58 

44 M5=1: il6=3; RETURN 

45 M5=1; M6=1; POKE 296 7 2 , P EEK (296 39 ) : POKE 

29673 ,PEEK(29638) : RETURN 

46 M4=W4+1;IF M4>127 THEN 47 ELSE 48 

47 115=2: M6=1 cRETURN 

48 il5 = 1: H5=1: a=256*PEEK (29647) >PEEK (29546) : POKE 

29672, PEEK (M + 1) : POKE 29573 , PEEK (H) : POKE 29674,51 : POKE 

29675,51: RETURN 

49 PRINT "YOU HAVE USED A RST ??? EMULATED WITH A NOP" 



50 


a5= 


1 : 


116=2: 


RETURN 


51 


IF 


(N 


AND 


64 ) =64 THEN 50 ELSE 46 


52 


IF 


(N 


AND 


1 ) =1 THEN 50 ELSE 46 


53 


IF 


(N 


AND 


4 ) =4 THEN 50 ELSE 46 


54 


IF 


(N 


AND 


128) =128 THEN 50 ELSE 46 


55 


IF 


(N 


AND 


64 ) =0 THEN 50 ELSE 46 


56 


IF 


(N 


AND 


1 ) =0 THEN 50 ELSE 46 


57 


IF 


(N 


AND 


4 ) =0 THEN 50 ELSE 46 


58 


IF 


(N 


AND 


128) =0 THEN 50 ELSE 46 



64 



APPENDIX K 



SINGLE STEP EXECUTION PROGRAM 4 



1 'S3EXEC4/BAS.DFC:0 

2 DEFSTR A-B:DEFINT I-Q 

3 M4 = PEEK (29652) : 30SUB 30:POKE 29652, M4 

4 N3= (PEEK (29648) AND 1) OR 2 

5 IF M5=2:N3=N3 OR 8 

6 IF M6=2:S3=N3 OR 16 

7 IF M6=3:N3=N3 OR 32 

8 POKE 29648, N3 

9 RUN "SSEXSCT/BAS .DFC :0" 

30 N1 = 256*PEEK (29651) +PEES (29650) : M = PESK(N1): N=M/16; GCSU5 
10: B1=B: N=M-N*16: GOSUB 10: B2=B 

31 M = PEEK (N1 +1) : N = M/16 :G05UB 10 : B3 = B : N=M-N'*‘ 1 6 : GOSUB 10:34=B 

32 A1="YOU ARE USING ":A2=" THIS WILL BE EXECUTED UNTIL 
":=PEEK ( 29640) 



33 


IF 


B1="1" 


AND 


B2="3" 


GOTO 


53 


34 


IF 


B1 ="3" 


AND 


B2="3" 


GOTO 


56 


35 


IF 


B1="3" 


AND 


32="0" 


GOTO 


57 


36 


IF 


31="2" 


AND 


82=" 8" 


GOTO 


58 


37 


IF 


B1 ="2" 


aND 


82="0" 


GOTO 


59 
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38 


IF 


B1 =''D'' 


AND 


B2=" 


D" 


AND 


B3 = 


"E" AND 34="9" GOTO 


50 


39 


IF 


B1 =''F» 


AND 


B2="D" 


AND 


B3= 


"S AND B4="9" GOTO 


6 1 


40 


IF 


B1 


AND 


32=" 


0" 


GOTO 
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41 


IF 


B1 ="E” 


AND 


B2=" 


D" 


T3EN 


42 


ELSE 75 




42 


IF 


B3="4» 


AND 


B2=" 


D" 


GOTO 


65 






43 


IF 


B3="4'' 


AND 


B2 = " 


5" 


GOTO 


66 






44 


IF 


B30''B 


" GOTO 75 












45 


IF 


B4=''0" 


GOTO 


67 












46 


IF 


B4='*8" 


GOTO 


68 












47 


IF 


B4 = ''1" 


GOTO 


69 












48 


IF 


B4="9'' 


GOTO 


70 












49 


IF 


34=1.2" 


GOTO 


71 












50 


IF 


B4="A" 


GOTO 


72 












51 


IF 


34="3" 


GOTO 


73 












52 


IF 


B4="B" 


THEN 


74 


ELSE 75 








53 


IF 


PEEK(N1 + 1) >1 27 


GOTO 55 









54 N1=M1+PSEK(N1 + 1) +2:N=:i1/256:POK2 29672, N: N=M 1- S*256: POKE 
29673, N: tl5 = 1 : M6 = l : SETUSM 

55 fl = 256-PEEK (N 1+ 1) : S 1 = N 1 -N^-2 : 3 5= 1 : M6 = 1 : H = N 1 /25 6 : POKE 
29672, H: M=N 1-N*256: POKE 29673, N: RETURN 

56 IF (I AND 1 ) =0 THEN 76 ELSE 53 

57 IF (I AND 1 )=1 THEN 75 ELSE 53 

58 IF (I AND 64) =0 THEN 75 ELSE 53 

59 IF (I AND 64) =64 THEN 75 ELSE 53 

60 M5 = 1 : H6=1: POKE 29672, PEEK (29543) : POKE 
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29673, PEEK(29642) ; RETURN 

60 as = 1: M6 = 1: POKE 2967 2, PEEK (29645) : POKE 

29673, PEEK(296424: RETURN 

62 IF (PEEK(29635) -1) =0 TfiEN 63 ELSE 54 



63 


POKE 


29674 


, 5:M5 = 


1 :M6=2 


: RETURN 








64 


POKE 


29674 


,5; IF 


(PEEK(N1 + 1) AND 123)=128 


THEN 


5 5 


65 


PRINT 


ai , " 


A RETI 


??? EMULATED WITH NOP": 


GOTO 


76 


66 


PRINT 


ai , '' 


A RBTN ??? 


EMULATED WITH NOP" 


: GOTO 


76 


67 


PRINT 


A1 , " 


LOIR 


”rA2," 


BC=0": GOTO 


75 






68 


PRINT 


A1 


LDDR 


",A2," 


BC=0" :GOT3 


75 






69 


PRINT 


A1 , " 


CPIS 


",A2, " 


BC=0" : GOTO 


75 






70 


PRINT 


A1, '• 


CP DR 


",A2," 


BC=0" : GOTO 


75 






71 


PRINT 


A1 , '• 


INIR 


",A2," 


B=0": GOTO 


75 






72 


PRINT 


A1 ," 


INDR 


",A2," 


B=0":GOTO 


75 






73 


PRINT 


A1 , '• 


OTIR 


" , A 2, " 


B=0": GOTO 


75 






74 


PRINT 


A1 , '• 


OTDR 


",A2," 


B=0"; GOTO 


75 






75 


M5=1; 


N6=3 ; 


RETURN 












76 


B5 = 1: 


M6=2: 


RETURN 
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APPENDIX L 



SINGLE STEP EXECUTION PROG HAN 5 



1 • SSEXEC5/BAS. DFC:0 

2 DEFSTR A-B:DEFINT I-Q 

3 M4 = PEEK (29652) : GOSUB 30;POKE 29652 , £14 

4 N3= (PEEK(29648) AND 1) OR 4 

5 IF M5=2 N3=N3 OR 8 

6 IF M6=2 N3=N3 OR 16 

7 IF M6=3 N3=N3 OR 32 

8 POKE 29648, N3 

9 RUN ''SSEXEC7/BA3 . DFC :0" 

30 N1=256*PEEK (29651) +PEEK (29650) : N=PSEK(N1): N = l/16: 
10: B1 = B: N=£l-N*16: GOSUB 10: B2 = B 

31 I=PEEK (29640) 



32 


IF 


B2=''3» 


GOTO 


50 






33 


IF 


B1=“C" 


AND 


B2=‘'D» 


GOTO 


51 


34 


IF 


B1="C" 


AND 


02=«2" 


GOTO 


52 


35 


IF 


31 ='»D” 


AND 


B2="2" 


GOTO 


53 


36 


IF 


B1 ="E” 


AND 


32=»2" 


GOTO 


54 


37 


IF 


B1 ="F” 


AND 


B2 = ''2» 


GOTO 


55 


38 


IF 


a 1 ="c" 


AND 


B2="A" 


GOTO 


56 



GOSUB 
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39 


IF 




AND 


B2="A" 


30T0 


57 


40 


IF 




AND 


CD 

li 


GOTO 


53 


41 


IF 


B1 =**F” 


AND 


B2="A" 


GOTO 


59 


42 


IF 


B1 


AND 


B2="4" 


GOTO 


60 


43 


IF 




AND 


B2="4 " 


GOTO 


61 


44 


IF 


B1 


AND 


B2="4" 


GOTO 


62 


45 


IF 


B1 =»F** 


AND 


B2 = '»4 " 


GOTO 


63 


46 


IF 


B1 


AND 


B2='*C" 


GOTO 


64 


47 


IF 


B1=**D** 


AND 


B2='»C” 


GOTO 


65 


48 


IF 


B1 =»*E** 


AND 


B2='»C" 


GOTO 


66 


49 


IF 


B1 


AND 


B2="C" 


THEN 
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50 M5=1: M6=l: POSE 29672 , PEEK (N 1 + 2| : POKE 29673 , PEEK ( N1 + 1 ) 
RETURN 

51 M4=M4-1: N=NH-3; a=N/256 : N = N-M»255 

M1 = 256*PEEK (29647) +PEEK(29646) ‘.POKE ai-1,a: POSE MI-2, N 

POKE 29674,59: POKE 29675,59: GOTO 50 

52 IF (I AND 64 ) =64 THEN 71 ELSE 50 

53 IF (I AND 1 ) =1 THEN 71 ELSE 50 

54 IF (I AND 4 ) =4 THEN 71 ELSE 50 

55 IF (I AND 128) =128 THEN 71 ELSE 50 

56 IF (I AND 64 ) =0 THEN 71 ELSE 50 

57 IF (I AND 1 ) =0 THEN 71 ELSE 50 

58 IF (I AND 4 ) =0 THEN 71 ELSE 50 

59 IF (I AND 123) =0 THEN 71 ELSE 50 

60 IF (I AND 64 ) =64 THEN 71 ELSE 51 
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61 IF (I AMD 1 )=1 THEN 71 ELSE 51 



62 IF (I AND 4 ) =4 THEN 71 

63 IF (I AMD 1281=128 THEM 

64 IF (I AMD 64 ) =0 THEN 7 

65 IF (I AMD 1 ) =0 THEM 71 

66 IF (I AND 4 ) =0 THEN 71 

67 IF (I AND 128) =0 THEN 7 

70 M5=1: M6=3;HETDRN 

71 M5 = 1: 116=2 IRETURM 



ELSE 51 
71 ELSE 51 
ELSE 51 
ELSE 51 
ELSE 51 
ELSE 51 
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APPENDIX a 



SINGLE STEP EXECUTION PORGRAa 6 

1 ‘SSEXECS/BAS-DFC :0 

2 DEFINT N 

3 N3=((PEEK (29648) AND 1) OR 6) OR 32 

4 POKE 29648, N3 

5 RUN ''SSEXEC7/BA5 .DFC :0'» 
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APPENDIX N 



SINGLE STEP EXECUTION PROGRAM 7 



1 • S3EXSC7/BAS. DFC:0 

2 CLEAR 300:DEFINT I-Q:DEFSTR A-B:DIM A(16) 

4 K=PEEK (296 49) 

5 LP=PEEK (29648) AND 1 

6 N3=256*PEEK(2965t) +PEEK(29650) 

8 IF PEEK (29672) OO THEN N1 = 256*PEEK (29672) +PSEK (29673 
ELSE N1=N3 

10 I = PEEK (29648) 

if and then ais?t2 else 

16 IF (I AND 48) =0 THEN .'!5 = 1 

18 IF (I AND 48) =16 THEN M6=2 

20 IF (I AND 48) =32 THEN M6 = 3 

22 IF (I AND 6) =0 THEN N2 = 1 

24 IF (I AND 6) =2 THEN N2=2 

26 IF (I AND 6) =4 THEN N2=3 

28 IF (I AND 6) =6 THEN N2=4 

30 POKE 29672, OiPOKE 29673,0 

32 ON M6 GOTO 41,40,34 

34 FOR Kl=29672 TO 2967H-N2 
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36 POKE K1 ,PEEK (N1) : m=N1 + 1 
38 NEXT K1 

40 N1=N3+N2 

41 N=N1/256: POKE 29651, N: N=N1-N*256: POKE 29650, H 

42 DEFUSR0=29653:X=USa0 (0) 

44 N=N3:0=4:G0SUB 100:A(15)=B 
46 FOB K1=0 TO 13 

48 N = PESK (29634 + K1) ;0=2;30SUB 1 00: A (K1 +2) =B 
50 NEXT K1 
52 FOR K1=0 TO 13 
54 A (K1) =A(K1+2) 

56 NEXT K1 

58 A (13) = A (1 3) + A (1 2) : A (9| = A (9) + A (8) : A { 1 1) = A (1 1) ^-A ( 1 0) 

60 B=A(16)+» '» + A(5)+" '» + A(7)+" '•+A(1)+» '•+A(0)+” " + A(3)+" 

”+A(2)+" "+A(5)+'' " + A(4)+'» ''+A(13)^-" '' + A(9)+" ">A(11) 

62 IF LP=0 PRINT 3 

64 IF LP=1 LPRINT 3 

66 IF a5v2 GOTO 70 

68 K=K<-1: POKE 29649, K; IF K>9 THEN RUN '• SSSXSC1 /BAS . DFC ; 0" 

ELSE RUN "SSEXEC2/BAS . DFC: O'* 

70 PRIxNT '»EHD OF SXECOTION’* 

72 RUN "MONITOR/BAS. DFC:0" 
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APPENDIX 3 



SINGLE STEP EXECUTION MACHINE LANGUAGE PROGRAM 



LOG 


LOC 


HEX CODE 


DEC 


HEX 




29653 


73D5 


ED73C073 


29657 


73D9 


31C273 


29660 


73DC 


Cl 


2966 1 


73DD 


D1 


29662 


73DE 


El 


29663 


73DF 


FI 


29664 


73E0 


DDE1 


29666 


73E2 


FDE1 


29668 


73E4 


ED7BCE73 




73E8 






73E9 






73EA 






73EB 




29676 


73EC 


ED73CE73 



MNEMONIC Commants 

LD(un),SP Save the basic 
language sp 
LD SP,nn Set stack 
pointer 
POP BC 
POP DE 
POP HL 
POP A? 

POP IX 
POP IT 
LD SP(nn) 



LD (nn) , SP 
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LOG 

DEC 

29680 

29683 

29685 

29687 

29688 

29689 

29690 

2969 1 

29695 



LOG 


HEf CODE 


HEX 




73F0 


31CE73 


73F3 


FDE5 


73F5 


DDES 


73F7 


F5 


73F8 


E5 


73F9 


D5 


73-?A 


C5 


73FB 


ED7bC073 


73FF 


C9 



MNEMONIC Cooimants 

LD SP,aa 
PUSH II 
POSH IX 
POSH AF 
POSH HL 
POSH DE 
POSH 3C 
LD SP (an) 

RET 
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iPPENDIX P 



DSTORE PROGSAa 



700 ’DSTORE: k PART OF A 3-80 :i ICROPRO CESS03 DEVELOPMENT AID 
FOR DISK BASIC ON THE TR5-80 BY DF CORTSVILLE APR 79 

701 DEFSTR A-B:DEFINT I-O 

705 PRINT "DSTORE MODE - TO STORE A PROGRAM ON THE DISK" 

710 INPUT "STARTING MEMORY LOCATION IN DECIMAL"; N1 

715 INPUT "ENDING MEMORY LOCATION IN DECIMAL";N2 

720 INPUT "INPUT FILENAME (NO MORE THAN 8 ALPHA-NUMERIC 
CHARACTERS AND ANY OPTIONAL PAR AMETERS) " ; A 

725 OPEN "0",1,A 

730 FOE N=N1 TO N2 

735 PRINT#1, PEEK (N) 

740 NEXT N 

745 CLOSE 1 

750 PRINT "PROGRAM DATA IS STORED IN ",A," NOTE THAI" 



-? /- 
/ o 



755 RUN "MONITOR/BAS. DFC;0" 



APPENDIX 2 



DRECALL PROGRAM 



300 'DRECALL: A PART OF A Z-80 MICROPROCESSOR DEVELOPMENT 

AID FOR DISK BASIC ON THE TRS-80 BY DF CORTEVILLE APR 79 

805 DEFSTR A-B;DEFINT N 

310 PRINT "DRECALL MODE - TO RECALL A PROGRAM FROM THE DISK" 

815 INPUT "STARTING MEMORY LOCATION IN DECIMAL" ;N1 

820 INPUT "ENDING MEMORY LOCATION IN DECIMAL" ;N2 

825 INPUT "FILENAME AS USED DURING DSIORE";A 

330 OPEN "I",1,A 

835 FOR N=N1 TO N2 

340 INPUT#1,N3 

845 POKE N,N3 

850 NEXT N 

855 CLOSE 1 

860 PRINT "THE PROGRAM HAS BEEN LOADED INTO MEMORY LOCATIONS 
",N1," TO ",N2 

365 RUN "MONITOR/BAS. DFC: 0" 
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APPENDIX R 



rSIORE PROGRAM 



700TSTORE: A PART OP A Z-80 MICROPROCESSOR DE7EL0PMENT AID 

FOR DISK BASIC ON THE TRS-80 BY DF CORTEVILLE APR 79 

710 DEFSTR A-B:DEFINT I-N:DIM 1(15) 

720 PRINT "TSTORE MODE TO STORE A PROGRAM ON TAPE RECORDER 

* 1 '» 

730 INPUT "STARTING MEMORY LOCATION IN DECIMAL" ;N1 

740 INPUT "ENDING MEMORY LOCATION IN DECIMAL" ;N2 

745 PRINT "NOTE STARTING TAPE COUNTER AND TURN ON THE 
RECORDER TO RECORD" 

750 FOR J=0 TO 15 

755 I(J) =PEEK(N1) : N1=N 1 + 1 

760 NEXT J 

765 PRINT#-1,I(0) ,I( 1) ,I (2) ,I (3) ,I (4) ,I (5) ,I (5) ,I (7) ,1(3) , 

1(9) rl(10),l (11) ,1(12) ,1(13) ,1(14) ,1(15) 

770 IF NKN2 GOTO 750 

775 PRINT "NOTE ENDING TAPE COUNTER" 

780 INPUT "CONTINUE TSTORE MODE (YES OR N0)";3 

785 IF a="YES" THEN 720 ELSE RUN "MONITOR/BAS. DFC: 0" 
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APPENDIX S 



C RECALL PROGRAM 



300 ‘TRECALL: A PART OF A Z-80 MICROPROCESSOR DEVELOPMENT 

AID FOR DISK BASIC ON THE TRS-80 BI DF CORTEVILLS APR 79 

805 DEFSTH A-B:DEFINI I-N:DIM 1(15) 

810 PRINT "TRECALL MODE TO RECALL A PROGRAM FROM THE TAPE 
RECORDER" 

815 INPUT "STARTING MEMORI LOCATION IN DECINAL";N1 

820 INPUT "ENDING MEMORI LOCATION IN 0ECIMAL";N2 

825 PRINT "TURN ON THE TAPE RECORDER (PLAY) AT THESTARTING 
COUNTER" 

330 INPUT "WHEN TAPE IS READY PRESS ENTER"; A 

350 INPUT#- 1,1 (0) ,1(1) ,I (2) ,I (3) ,I (4) ,I (5) ,1(6) ,1(7) ,I (3) , 
1(9) ,1(10) ,I (11) ,I (12) ,1(13) ,1(14) ,I (15) 

355 FOR J=0 TO 15 

360 IF N1>N2 GOTO 870 

865 POKE N1 ,I (J) :N1 = NH-1 

870 NEXT J 

875 IF N1>N2 THEN 850 ELSE RON "MONITO H/3 AS . DFC; 0 " 
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10 

11 

12 

13 

14 

15 

16 

17 

13 

19 

20 

21 

22 

23 

24 

25 

26 



APPENDIX r 



SOBRQDTINE 10 DECIMAL 10 3EX CONVERSION 



IF 


o 

II 


B="0” 


IF 


N=1 


B= " 1 '• 


IF 


N=2 


B="2” 


IF 


N=3 


B="3" 


IF 


N = 4 


B= 11411 


IF 


N=5 


B="5" 


IF 


N =6 


B='* 6 " 


IF 


II 


B="7" 


IF 


N = 8 


3= '‘ 8 ” 


IF 


N=9 


B="9" 


IF 


N= 10 


B='*A'' 


IF 


N= 1 1 


B='*B" 


IF 


N= 12 


1 B='»C" 


IF 


M=13 


B=“D'* 


IF 


N=14 


. B='*E” 


IF 


N=15 


1 B="F" 


RETURN 
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APPENDIX U 



SUBROUTINE 100 DECIMAL TO HEX CONVERSION 

110 d=16 :tl1=256:M2=4096:IF 0 = 4 GOTO 115 
105 IP 0 = 2 GOTO 120 

115 I (0) =N/M2: N=N-I (0) *M2 :I (1) =N/M1 :N = N-I(1)<‘M1:I (2) =N/M 
I (3) =N-I (2) *M:GOTO 130 

120 I (0) =N/M:I (1) =N-I (0) *M 



130 FOR J=0 TO 0-1 




140 IF I (J) =0 A (J) = 


rllQll 


141 IF I (J) =1 A (J) = 


rfl 'I II 


142 IF I (J) =2 A(J) = 




143 IF I (J) =3 A (J) = 


rif 3 If 


144 IF I (J) =4 A (J) = 


= H 411 


145 IF I (J) =5 A(J) = 


>fl 5 II 


146 IF I (J) =6 A (J) = 




147 IF I (J) =7 A (J) ^ 


= 11 711 


148 IF I (J) =8 A (J) = 


= 11311 


149 IF I (J) =9 A(J) = 


=11 9 II 



150 IF I (J) =10 A (J) ="A" 

151 IF I (J) = 1 1 A (J) ='’B" 

152 IF I (J) = 12 A (J) ="C‘ 
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153 IF I (J) =13 4 (J) ="D" 

154 IF I (J) =14 A (J) ="E" 

155 IF I (J) = 15 A (J) =»F" 

156 NEXT 

170 IF 0=2 THEN B=A(0)+A(1) 

180 IF 0=4 THEN B= A (0) +A ( 1 ) + A (2) +A (3 ) 
190 SETORN 
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220 

210 

220 

221 

222 

223 

224 

225 

226 

227 

228 

228 

229 

230 

231 

232 

23 3 

234 



APPENDIX 7 



SOBROOriNE 200 HEX TO DECIMAL CONVERSION 

A (0) =LEFT$ (B, 1) : A ( 1) =HID$ (B, 2, 1) : H3=16 
FOR J=0 TO 1 



IF A (J) ="0» 


I(J) =0 


IF A (J) ="1" 


I(J) =1 


IF A IJ) ="2" 


I(J) =2 


IF A (J) ="3« 


I(J) =3 


IF A (J) =»4" 


I(J) =4 


IF A (J) ='*5" 


I(J) =5 


IF A (J) ="6*' 


I(J) =6 


H 

II 


I(J) =7 


IF A (J) ="8" 


I(J) =8 


IF A (J) =«8'« 


I(J) =8 


IF A (J) ="9» 


I(J) =9 


IF A(J)="A" 


I(J) =1 0 


IF A(J)="B" 


I(J)=1 1 


IF A(J)=«C*' 


I (J) =12 



IF A (J) =»D" I (J) =13 
IF A (J) ="E« I ( J) =14 
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235 


IF A (J) =•’ 


F'* I (J) =15 


236 


IF A (J) ='• 


'» I(J) =0 


240 


NEXT 




250 


N=M3*I(0) 


+ 1(1) 


260 


RETURN 
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DEC 

29632 

29634 

29635 

29636 

29637 

29638 

29639 

29640 

29641 

29642 

29644 

29646 

2 964 8 

29649 



APPENDIX H 



SINGLE STEP EXECUTION MEMORY MAP 



HEX 


Co (it eats 


73C0 


Basis language stack 


73C2 


C register 


73C3 


B register 


73C4 


E register 


73C5 


D register 


73C6 


L register 


73C7 


H register 


73C8 


F register 


73C9 


A register 


73CA 


IX register 


73CC 


lY register 


73CE 


Stack pointer 


73D0 


DO is LP 




D1 and D2 are N2 




D3 is M5 




D4 and D5 are d5 


73D1 


K 
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DEC 

29650 

29651 

29652 

29653 

to 

29671 

29672 

to 

29675 

29676 

to 

29695 



HEX Coitaats 

73D2 N1 (PClow) 

73D3 Ml (PChigh) 

73D4 H4 

73D5 Maotine languaga program 
to 

73E7 Appeadix D 

73E8 Four bytes for 

to 

73EB Executed step 
73EC Machiae lauguage program 
to 

73PF Appendix 3 
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APPENDIX X 



LAB 1 



1. Place a chair in front of the IRS-80. 

2. Check six 60hz AC po^er cords (two from the expansion 
interface, one from video display, one from the tape 
recorder, one from the mini disk drive, and one from 
the line printer interface) . 

3. Check that the video display is connected to the micro 
computer system (keyboard) in the plug marked video 
(center plug) . 

4. Check that the tape recorder plug is connected to the 
keyboard at the plug marked tape; and to the tape 
recorder as follows: black to EAR, large gray to AUX, 
and small gray to REaCTE. 

5. Check that the keyboard is connected to the expansion 
interface with a forty pin edge connector and a power 
cord to the plug marked power on the keyboard. 

6. Check that the line printer interface is connected to 

the expansion interface with a forty pin edge 

connector. 

7. Check that the mini disk drive is connected to tae 
expansion interface. 

8. Place the line printer interface on/off switch to on 
then press the reset push button. (note: If the line 
printer interface is off, then the mini disk drive and 
expansion interface will not work.) 
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9. Turn on the video display. Press the power switch in. 

10. Place the operating system mini dish, a Z-30 

microprocessor development aid, in the mini disk drive. 

The catalog number should be showing on the bottom 

right. Close the mini dish drive door. 

11. Turn on the mini disic drive. On is up on the switch on 
the back of the mini disk drive. 

12. Turn on the expansion interface. Push in the button 

switch on the center front of the expansion interface. 

13. Turn on the keyboard. Push in the button switch on the 
rear right of the keyboard. The mini disk drive should 
turn on thus loading the TRSDOS (TRS disk operating 
system) into the RAM. The following appears on the 
video display: 

TRSDOS - DISK 0P2RTINS SYSTEM - 7 ER 2.1 
DOS READY 

14. Type BASIC and push EMTER. 

15. For the question, MANY PILES?, press ENTER. This 

defaults on three files. 

16. For the question, MEdORY SIZE?, type 29630 and press 
ENTER. 

17. RADIO SHACK DISK BASIC VERSION 1.1 
READY 

Appears on the video display, type RUN "S" and press 
ENTER. 

18. MONITOR PROGRAM 

A Z-30 MICROPROCESSOR DEVELOPMENT AID 
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SHORT OR LONS EXPLANATION? INPUT S OR L? 



Appears on the video display, type L and press ENTER. 

19. The long explanation for each mode appears oa the video 
display, type S and press ENTER. 

20. The short explanation appears on the video display, 
type DRECALL and press ENTER. 



21. The disk recall 


progr 


am 


is 


now asking 


for 


a beginning 


memory location 


to 


1 


oad 


a program 


into 


RAM from the 


disk, type 29696 


and 


pr 


ess 


ENTER. 







22. The ending nemory location is required, type 29710 and 
press ENTER. 



23. A filename is required, type lESTPR#! and press ENTER. 

24. Steps 22 to 24 are unique for this lab and are 
dependent on the program to be loaded. The monitor 
program is requesting a long or short explanation. Type 
1 and press ENTER. 

25. Examine the program just entered into the RAM, type 
DUMP and press ENTER. 

26. For starting memory location, type 29696 and press 
ENTER. 

27. For the number of memory locations, type 15 and press 
ENTER. 

28. For video output type V and press ENTER. This shows 
the oeginning decimal memory location, tae beginning 
hexadecimal memory Location and the concents of the 
following 15 memory Locations. 

29696 7400 21 00 3C 3S BF 06 02 77 23 05 C8 C3 07 74 FF FF 

29. Type NO and press ENTER. This returns to the monicor 
program . 
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30. Type S and press ENrS)R. 

31. The LOAD mode will be used to change location 7406 from 
02 to FF. Type LOAD and press ENTER. 

32. Type 29702 and press ENTER. 

33. Type FF and press ENTER. 

34. Exit the LOAD mode, type QOIT and press ENTER. This 
returns to the monitor program. 

35. Type S and press ENTER. 

36. Repeat steps 26 to 29. The 02 in memory location 7403 
is now FF. 

37. Press ENTER (no is the default) . This returns to the 
monitor program. 

38. Type S and press ENTER. 



39. 



Type EXEC and press ENTER to execure the test program. 



40. Type 29696 and press ENTER for the starting memory 
location. 



41. The top four lines of the video display are whitened 
out, 256 video memory locations. 

42. Press ENTER (no is the default). This returns to the 





monitor program 


43. 


Type 


S and pres 


44. 


Type 

This 


END and pc 
ends lab 1 


TESTPR11 




MEM 


LOG 


OPCODE 



7400 



21003C 



MNEMONIC 
LD 3L, 3C00 
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7403 


3EBF 


LD i, BF 


7405 


06FF 


LD B,FF 


IHQI 


77 


LD (BL) ,A 


7408 


23 


INC HL 


7409 


05 


DEC B 


740A 


C8 


REI Z 


740B 


C30774 


JP 7407 



91 



APPENDIX r 



LAB 2 



1. Power up the system by completing steps 1 through 18 of 
lab 1. 

2. Type S and press ENTER. 

3. Recall test progrim number 4 from the disk; type 
DRECALL and press ENTER. 

4. Type 29696 and press ENTER for the starting memory 

location. 

5. Type 29770 and press ENTER for the ending memory 

location. 



6 . 

7. 

3. 

9. 



Type TESTPR04 and press ENTER for the filename. 

Type S and press ENTER. 

Type DUMP and press ENTER. 

Type 29696 and press ENTER for the starting memory 
location. 



10. Type 74 and press ENTER for the number of memory 
locations. 

11. Connect the cable from the line printer interface to 
the line printer and turn on the printer. 

12. Type LP and press ENTER to make a hardcopy of the 
program. There is a 20 second delay between pressing 
ENTER and the first output which will look like this: 
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29696 


7400 


AF 


31 


00 


75 


3S 


BF 


21 


F8 


3P 


77 


CD 


10 


74 


77 


C9 


00 


29712 


7410 


06 


02 


05 


00 


CA 


00 


74 


05 


77 


CC 


20 


74 


77 


C9 


00 


00 


29728 


7420 


06 


02 


77 


05 


20 


FD 


CD 


30 


74 


77 


C9 


00 


00 


00 


00 


00 


29744 


7430 


DD 


21 


3F 


74 


?0 


2 1 


47 


74 


77 


DD 


E9 


77 


00 


FD 


E9 


06 


29760 


7 440 


03 


77 


10 


F7 


C3 


3B 


74 


77 


C9 


00 


00 


00 


00 


00 


00 


00 



13. Press ENTERING is the default. 



14. 

15. 

16. 
17. 



Type S and press ENTER. 

Type S3 EXEC and press ENTER. This starts the single 
step execution mode. 

Type 7 and press ENTER. 

Type 29696 and press ENTER for starting memory 
location. 



18. Single step execution requires about 20 seconds for 
each step. Use this time to anticipate the next step. 
The printout produced in step 12 or the program at the 
end of this lab should be used. 



19. Note the four levels of calls and the use of the video 
RAa location 3FF8 as a LED. 

20. After end of execution, type S and press ENTER- 

21. Type END and press ENTER. 

22. This ends lab 2. If the student needs more practice, 
then redo lab 2 using LP instead of 7 in step 16 to 
obtain a hard copy of the execution. 



TEST PROGRAM #4 



MEM LOG 
7400 



OPCODE 

AF 



MNEMONIC 
XRA A 
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7401 


3 10075 


LD SP, 7500 


7404 


3EBF 


LD A,BF 


7406 


21F83F 


LD HI, 3FF8 


7409 


LD (HL) , 


A 


740A 


GD1074 


GALL 7410 


740D 


77 


LD (HL) ,A 


740E 


G9 


RET 


740F 


00 


NOP 


dEH LOG 


OPGODE 


dNEdONIG 


7410 


0602 


LD B, 02 


7412 


05 


DEG B 


7413 


00 


NOP 


7414 


GA0074 


JPZ 7400 


7417 


05 


DEG B 


7418 


77 


LD (HL) ,A 


7419 


GG2074 


CZ 7420 


741C 


77 


LD (HL) ,A 


741D 


G9 


RET 


741E 


00 


NOP 


741F 


00 


NOP 


dEd LOG 


OPGODE 


dNEHONIG 


7420 


0602 


LD B, 02 


7422 


77 


LD (HL) , A 


7423 


05 


DEG B 
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7424 



20FD 



JRNZ FD 



7426 


GD3074 


GALL 7430 


7429 


77 


LD (HL) , A 


74 2A 


G9 


RET 


742B 


00 


NOP 


74 2C 


00 


NOP 


742D 


00 


NOP 


742E 


00 


NOP 


742F 


00 


NOP 


MEM LOG 


OPGODE 


HNEaONIG 


7430 


DD213F74 


LD rx, 743 


7434 


FD214774 


LD rr 7447 


7438 


77 


LD (HL) , A 


743A 


DDE9 


JP (EX) 


743B 


77 


LD (HL) ,A 


743C 


00 


NOP 


743D 


FDE9 


JP(EI) 


743P 


0603 


LD B,03 


aEH LOG 


OPGODE 


MNEaONIG 


7441 


77 


LD (HL) , A 


7442 


10F7 


DJNZ F7 


7444 


G33B74 


JP 743B 


7447 


77 


LD (HL) , A 


7448 


G9 


RET 
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APPENDIX Z 



LAB 3 



1. Power up the system by completing steps 1 thcough 18 of 
lab 1. 



2. Type S and press ENTER. 

3. Type LOAD and press ENTER to load your machine language 
program into the RAN. 

4. Type the starting meiory location in decimal and press 
ENTER. Protected memory locations are 29695 to 33777. 
Use the machine language program at the end of this lab 
if you did not write one prior to this lab session. 

5. Type the opcode one memory location at a time and press 

ENTER. For each memory location the system displays 

the memory address ind the previous contents. If ENTER 
is pressed without data, then the memory content is not 
changed. 

6. Type QUIT and press ENTER when the complete program is 
entered . 



7. Type S and press ENTER. 

8. Type DUMP and press ENTER. 

9. Type the starting memory location in decimal and press 
ENTER. 



10 . 



Type the number of memory locations in decimal and 
press ENTER. 
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11. Type V or LP for viiao or lineprinter and press ENTER. 

12. Compare the output with the desired program. 

13. Debug the program using the execution mode as used in 
lab 1 and the single step execution mode as used in lab 

2 . 



14. Ose the load and dump modes to change and verify the 
program if necessary. 



15. 


Save 


the 


machine 


langaage 


program on 


the disk drive. 




From 


the 


moni tor 


program 


type DSrORE 


and press ENTER. 


16. 


Type 


the 


starting 


mamor 7 


location in 


decimal and press 



ENTER. 

17. Type the ending memory location in decimal and press 
ENTER. 

18. Type a filename (your initals will be fine and easy to 
remember) and press ENTER. 

19. Type S and press ENTER. 

20. Save the machine language program on the tape recorder. 
Place a tape in the tape recorder, remember the rape 
counter number, and press the record and play buttons 
simultaneously. 

21. Type TSTORE and press ENTER. 

22. Type the starting memory location in decimal and press 
ENTER. 

23. Type the ending memory location in decimal and press 
ENTER- 

24. Note the ending tape counter number. Press ENTER, NO 
is the default. 

25. Press the stop button on the tape recorder. 



26. Type S and pcess ENTER. 

27. Retrieve the machine language program from the tape 
recorder. Rewind the tape recorder to the starting 
tape counter number. Place the tape recorder in play. 

28. Type THECALL and press ENTER. 

29. Pick a new starting memory location. Type the new 
starting memory location and pcess ENTER. 

30. Type the new ending memory location and pcess ENTER. 

31. The tape recorder should be ready so prsss ESTER. 

32. * Type 5 and pcess ENTER. 

33. Use the dump mode to verify the machine language 
program retrieved from the tape recorder. 

34. Secure the system from the monitor program. Type END 
and press ENTER. 

35. This ends lab 3. The student has operated every mode 
of the Z-80 microprocessor development aid. For a 
discussion of the system read The Design and 
Implementa tion of an Iil 252 i£sive Si cco process or 
Developmen t Syst em * for the Z-80 Mi croprocessor , a 
thesis, by D. F. Corteville June 1979. 

SAMPLE PROGRAM 



MEM LOG 


OPCODE 


MNEMONIC 


7400 


1 802 


JR 32 


74 02 


00 


NOP 


7403 


00 


NOP 



7404 



3EAA 



LD A, AA 



7406 


1805 


JR 05 


7408 


00 


NOP 


7409 


00 


NOP 


740A 


06BB 


LD B, 


740C 


00 


NOP 


740D 


00 


NOP 


740E 


00 


NOP 


740F 


C9 


RET 
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